﻿<!DOCTYPE HTML>
<html lang="zh">
<head>
<title>SubStr - 语法 &amp; 使用 | AutoHotkey v2</title>
<meta name="description" content="The SubStr function retrieves one or more characters from the specified position in a string." />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
<script type="text/javascript">$(function(){0<=window.navigator.userAgent.toLowerCase().indexOf("ucbrowser")&&CaoNiMaDeUc()})</script>
</head>
<body>

<h1>SubStr</h1>

<p>从字符串中的指定位置检索一个或多个字符.</p>

<pre class="Syntax">NewStr := <span class="func">SubStr</span>(String, StartingPos <span class="optional">, Length</span>)</pre>
<h2 id="Parameters">参数</h2>
<dl>

  <dt>String</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
    <p>要复制其内容的字符串. 这可能包含二进制零.</p>
  </dd>

  <dt>StartingPos</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#numbers">整数</a></p>
    <p>指定 1 从首个字符开始, 2 从第二个开始, 依此类推(如果  <em>StartingPos</em> 为 0 或 超过了 <em>String</em> 的长度, 则返回空字符串).</p>
    <p>指定一个负的 <em>StartingPos</em> 以从右边的那个位置开始. 例如, -1 提取最后一个字符, 而 -2 提取最后两个字符(但是, 如果 <em>StartingPos</em> 试图超出字符串的左端, 提取将从第一个字符开始).</p>
  </dd>

  <dt>Length</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#numbers">整数</a></p>
    <p>如果省略这个参数, 则默认为 "全部字符". 其他情况下, 为需提取字符的最大数目(当字符串剩余部分太短时提取的数目会比最大值少). 您还可以指定负的 <em>Length</em> 从而在返回字符串的末尾省略这个数目的字符(如果省略了全部或过多字符, 则返回空字符串).</p>
  </dd>

</dl>

<h2 id="Return_Value">返回值</h2>
<p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
<p>此函数返回所请求的指定字符串的子字符串.</p>

<h2 id="Related">相关</h2>
<p><a href="RegExMatch.htm">RegExMatch</a></p>

<h2 id="Examples">示例</h2>
<div class="ex" id="ExBasic">
<p><a href="#ExBasic">#1</a></p>
<pre>MsgBox SubStr("123abc789", 4, 3) <em>; 返回 abc</em></pre>
</div>

<div class="ex" id="ExEnd">
<p><a href="#ExEnd">#2</a></p>
<pre>String := "The Quick Brown Fox Jumps Over the Lazy Dog"
MsgBox SubStr(String, 1, 19)  <em>; 返回 "The Quick Brown Fox"</em>
MsgBox SubStr(String, -8)  <em>; 返回 "Lazy Dog"</em>
</pre>
</div>

</body>
</html>